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SECTION  1 - INTRODUCTION 


lose  and  Scope 


The  purpose  of  the  Timing  Analysis  Report  Program  (TARP)  User's  Manual 
is  to  explain  what  services  are  provided  to  CFC  development  programmers 

by  the  TARP  and  to  explain  the  required  procedures  needed  to  use  the 

i 

program.  This  document  will  be  updated  as  the  program's  services  and 
operating  procedures  change. 


1.2  Background  Information 

This  program  was  developed  to  assist  test  programs  in  reducing  and  analyzing 
test  data  during  CFC  Monitor  system  testing.  It  was  developed  to  execute 
in  the  NOSS  environment  and  was  modified  to  permit  its  operation  under 
OS/9020. 


1 . 3  References 

The  following  document  may  help  the  programmer  use  this  manual 

Timing  Analysis  Report  Program  (TARP)  Subprogram  Design  Document 
(SDD)7  NASP-9127-latest  revision.  Contract  FA65WA-1395, 

IBM  Corporation,  NAFEC,  Atlantic  City,  New  Jersey. 


1 . 4  Document  Summary 

Section  2,  Program  Environment,  specifies  both  the  required  and  optional 
hardware  configuration.  The  minimum  and  maximum  number  of  elements  and 
devices  that  may  be  configured  are  also  specified. 

Section  3,  Program  Operation,  describes  the  services  provided  by  this 
program.  In  addition  to  explaining  how  to  use  each  service,  this  section 
describes  any  program  restrictions  that  might  affect  the  user. 
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Section  4,  Input,  explains  the  purpose,  format,  and  content  of  each  input 
message  that  is  processed  by  TARP. 

Section  5,  Output,  explains  the  purpose,  format,  and  content  of  each  output 
produced  by  TARP.  Sample  printouts  are  also  included. 

Section  6,  Diagnostics,  explains  the  cause,  format,  and  meaning  of  each 
diagnostic  message  produced  by  TARP. 

Section  7,  Job  Control  Language,  explains  the  JCL  needed  to  execute  TARP 
under  OS/9020. 


SECTION  2 - PROGRAM  ENVIRONMENT 


Figure  2-1  illustrates  th'*  minimum  system  configuration  required  to 
run  TARP. 


.SYS IN 


. SYSOUT 


Minimum  Tape  Requirement 
Maximum  Tape  Requirement 


LEGEND:  R - Required 
T - Tape 
C - Card 
P - Printer 


Figure  2-1.  TARP  System  Environment 


2-1 


PRECEDING  PAGE  BLAMUNOT  FILKED 


SECTION  3 - PROGRAM  OPERATION 

■ 

TARP  reduces  SAR  tape  records  by  selectively  printing  TAR  timing  infor- 
mation  and  providing  surrsnary  information.  Program  TARP  will  output 
timing  information  for  any  CFC  subprogram  specified.  The  following 
capabilities  exist: 

[ I # 

a.  Multiple  SAR  input  tapes  may  be  read 

b.  Multiple  time  intervals  for  reading  the  SAR  tape  for  each 
CFC  subprogram  are  possible 

c.  Multiple  subprogram  requests  are  possible 

d.  Multiple  phase  combinations  are  possible 

e.  Printer  output  is  possible 

TARP  operates  independently  under  0S/9020,  but  is  dependent  on  the  CFC 
Monitor  subprograms  that  format  and  write  the  SAR  tapes. 


r 


I 


! 


s 


$ 


HOCEQINQ  Pi.GS  BLiMUNOT  JlLfcED 

[ 

SECTION  4 - INPUT 

# 

4 . 1 General 

TARP  is  divided  into  five  phases.  One  phase  is  concerned  with  Program 
Element  execution  time  and  frequency  of  program  activation.  Another 
phase  provides  data  on  parallel  program  operation.  A third  phase  pro- 
vides an  SVC/ Subprogram  cross-reference,  while  the  fourth  phase  deals 
with  TAR  recordings  which  were  purge  processing  TARs.  The  fifth  phase 
deals  with  the  generation  of  an  HRT  tape.  Control  and  request  cards  are 
used  to  select  which  type  of  study  should  be  made  on  which  subprograms 

t 

for  some  time  interval. 

4.1.1  Program  Element  Execution  Time  Study  Phase  (Phase  1) 

Time  study  information  includes  activate,  finish,  active,  execution,  and 

4 

suspend  times  along  with  meaningful  time  differentials.  Requests  for 
several  subprograms  can  be  issued. 

When  more  than  one  subprogram  is  requested,  the  listings  are  not  separated, 
i.e.,  they  are  output  in  time  sequence.  Summary  information  is  listed 
at  time  intervals  as  specified  by  the  summary  parameter  on  the  request  card. 

The  frequency  of  subprogram  activation  is  also  analyzed  for  requested 
subprograms.  The  time  between  activation  of  the  subprogram  is  accumulated 
with  the  minimum  and  maximum  times.  The  number  of  times  the  subprogram 
is  activated  is  also  registered.  At  the  end  of  the  run,  the  average 
time  between  activations  is  calculated.  If  the  user  specifies  an 
expected  subprogram  activation  frequency  on  the  request  card,  the 
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expected  frequency  and  the  actual  frequency  are  compared  and  a percent 
error  is  calculated.  If  the  user  does  not  specify  an  expected  sub- 
program frequency,  the  percent  error  is  not  calculated. 

A list  is  then  generated,  listing  the  subprogram  name,  expected  sub- 
program frequency  (as  specified  by  the  user),  actual  frequency  as  cal- 
culated, percent  error,  and  minimum  and  maximum  times  between  activations, 

4.1.2  Parallel  Program  Operation  Study  Phase  (Phase  2) 

This  study  provides  information  on  a time  basis  for  22  subprograms. 

In  time  sequence,  a listing  is  generated  which  shows  the  activity  of 
each  subprogram,  such  as  suspended,  activated,  executing,  or  finished. 

A legend  is  also  printed  which  explains  the  meaning  of  each  of  the 
activity  codes.  There  is  no  limit  to  the  number  of  time  spans  that  may 
be  selected  per  run,  as  long  as  they  are  in  start  time  order  and  one 
request  does  not  overlap  another  request. 

4.1.3  SVC/Subprogram  Summary  Phase  (Phase  4) 

This  study  summarizes,  for  a particular  time  interval,  the  number  of  times 
each  SVC  was  issued  for  each  subprogram  and  the  total  number  of  times 
SVCs  were  issued.  The  summary  also  shows  the  total  number  of  times  each 
SVC  was  issued  by  al'l  subprograms.  At  the  end  of  the  listing,  the  total 
TAR  records  read  and  the  total  TAR  errors  encountered  during  this  run  are 
shown.  There  is  no  limit  to  the  number  of  requests  that  may  be  made  per 
run,  as  long  as  the  requests  are  in  start  time  order  and  one  request  does 
not  overlap  another  request. 
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4.1.4  Purge  Processing  History  (Phase  8) 

This  study  summarizes,  for  a particular  time  interval,  the  TAR  recordings 
which  were  purge  TARs.  For  the  requested  time  interval,  the  user  will 
receive  a one-line  printout  for  each  purge  TAR,  indicating  its  time, 
the  highest  purge  class  invoked,  the  purge  class  breakdown,  the  number 
of  2K  blocks  requested  to  be  purged  and  actually  purged,  and  the  number 
of  modules  purged.  At  the  conclusion  of  each  time  interval,  a purge 
summary  is  printed.  This  includes  the  total  number  of  purges,  the  total 
number  of  2K  blocks  purged,  the  minimum,  maximum,  and  mean  number  of  2K 
blocks  purged,  and  the  average  time  interval  between  purges.  For  each 
purge  class  (1-8),  the  number  of  times  a class  is  reached  during  a 
purge  and  the  percentage  of  the  total  reached  are  also  printed. 

There  is  no  limit  to  the  number  of  requests  that  may  be  made  per  run, 
as  long  as  the  requests  are  in  start  time  order  and  one  request  does 
not  overlap  another  request.  However,  it  should  be  noted  that  Phase  8 

processing  is  a stand-alone  function,  i.e.,  it  cannot  be  requested  in 

■ 

the  same  run  with  Phase  1,  2,  or  4 functions. 

4.1.5  HRT  Generation  (Phase  9) 

Phase  9 will  produce  a paeudo-HRT  tape  in  a format  acceptable  to  the 
reduction  program,  REDUC,  to  allow  the  generation  of  statistical  reports 
on  I/O  interrupts,  external  interrupts,  SVC  interrupts,  and  encoded 
program  element  interrupts. 


4 ■ 2 Card  Input 

Figure  4-1  illustrates  a sample  input  deck  for  TARP. 

4.2.1  Model  Control  Card  Format 

Thi3  card  informs  TARP  which  model  produced  the  TAR  records,  If  this 
card  is  not  used,  Model  3 is  assumed.  The  model  control  card  is  not 
applicable  to  the  CFC  System  and  should  not  be  provided. 

Card 

Columns:  0 0 

1 7 

MODEL  a 

where 

a = 1 for  model  1 

3 for  model  3 

4 for  E-type  TARs 


4.2.2  Phase  Control  Card  Format 

This  card  informs  TARP  what  data  requests  are  to  be  honored,  A request 

for  any  phase  except  those  indicated  below  is  rejected.  Phase  8 cannot 

be  run  in  the  same  job  with  other  phases. 

Card 

Columns: 

13  5 

a b cccc 


PE  Execution  Time  Study  Phase  (See  Figure  4-1) 

Parallel  Program  Operation  Study  Phase  (See  Figure  4-2) 
Phase  1 and  Phase  2 (See  Figure  4-3) 

SVC/Subprogram  Summary  Phase  (See  Figure  4-4) 

Phase  1 and  Phase  4 (See  Figure  4-5) 

Phase  2 and  Phase  4 (See  Figure  4-6) 

Phase  1 and  Phase  2 and  Phase  4 (See  Figure  4-7) 

Phase  8 must  be  run  alone.  It  cannot  be  run  with  any 

other  phase 

Phase  9 must  be  run  alone.  It  cannot  be  run  with  any 
other  phase 


where 

a = 1 - 
2 - 

3 - 

4 - 

5 - 

1 6 - 


7 - 


<♦ 
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//SYSIN  DD  * 

1 N 0300 

SIMC  002900  013000  0015  0012 
N1MC  002900  003000  0015  0030 
GIMC  002900  003000  0015  0010 
TITC  002900  003000  0015  0013 
IMLC  002900  013000  0015  0012 
OMLC  002900  003000  0015  0030 
SOTC  002900  003000  0015  0010 
STUP  002900  003000  0015  0013 
ENDPH1 
/* 


Figure  4-1.  Sample  Input  Deck  - Phase  1 


//SYSIN  DD  * 

2 N 0300 

PH2TIME  000000  000300  SIMC,NIMC,CIMC,TITC,IMLC,OMLC,TMLC,SOTC,CTY 
PH2TIME  000310  000320  SIMC,NIMC,CIMC,T1TC,IMLC,0MLC,TMLC,S0TC,CTY 
EMDPH2 

/* 


Figure  4-2.  Sample  Input  Deck  - Phase  2 


//SYSIN  DD  * 

3 N 0300 

SIMC  002900  013000  0015  0012 
NIMC  002900  003000  0015  0030 
TITC  002900  003000  0015  0030 
CSD  002900  003000  0015  0030 
ENDPH1 

PH2TIME  000000  000300  SIMC, NIMC, CIMC, TITC, IMLC ,OMLC ,TMLC ,S0TC ,CTY  ,CSS 
PH2TIME  000310  000320  SIMC, NIMC, CIMC, TITC, IMLC, OMLC,TMLC,SOTC,CYT  ,CSS 
ENDPH3 

/* 


figure  4-3.  Sample  Input  Deck  - Phases  1 and  2 


//SYSIN  DD  * 

4 N 0300 

PH4TIME  000000  000300 
PH4TIME  000310  000320 
ENDPH4 

/* 


Figure  4-4.  Sample  Input  Deck  - Phase  4 


. 


//SYSIN  DD  * 

5 N 0300 

SIMC  003000  003100  0015  0006 
TITC  003000  003100  0015  0006 
SOTC  003000  003100  0015  0006 
CSD  003000  003100  0015  0006 
LISA  003000  003100  0015  0006 
ENDPH1 

PH4TIME  000000  000300 
PH4TIME  000310  000320 
ENDPH5 

/* 


Figure  4-5.  Sample  Input  Deck  - Phases  1 and  4 


//SYSIN  DD  * 

6 N 0300 

PH2TIME  000000  002900  SIMC,TMLC,AQDC,CSD  .CAPL.ARRD 
PH4TIME  002900  003000 

PH2TIME  003000  003100  SIMC,TMLC,AQDC,CSD  ,CAPL,ARRD 
PH4TIME  003200  003300 
ENDPH6 
/* 


r 


j 

Figure  4-6.  Sample  Input  Deck  - Phases  2 and  4 
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//SYSIN  DD  * 

7 H 0300 

SIHC  002900  013000  0015  0012 
NIMC  002900  003000  0015  0030 
TITC  002900  003000  0015  0030 
CSD  002900  003000  0015  0030 
ENDPH1 

PH2TIME  000000  000300  SIMC, NIMC, CIMC, TITC, IMLC,OMLC,TMLC,SOTC,CTY  ,CSS 
PH2TIME  000310  000320  SIMC ,NIMC, CIMC, TITC, IMLC,OMLC,TMLC,SOTC,CTY  ,CSS 
ENDPH3 

PH4TIME  000330  000350 

PH2TIME  000000  000360  SIMC, NIMC, CIMC, TITC, IMLC,OMLC,TMLC,SOTC,CTY,  CSS 
ENDPH7 


Figure  4-7.  Sample  Input  Deck  - Phases  1,  2,  and  4 


b = N - Compool  not  on  File  2 of  first  SAR  tape 
Y - Compool  is  on  File  2 of  first  SAR  tape 

cccc  = interval  timer  units/sec  - 0300  is  usual  unless  SETT  has  been 
used  in  CFC  run 

4.2.3  Phase  1 Request  Card  Format 

This  card  is  used  to  request  activation  and  execution  timing  information 
for  a specified  period  of  time.  (See  Figure  4-1). 

Card 

Columns : 122 


aaa(a)  cccccc  dddddd  eeee  ffff 


where 


aaa(a)  = subprogram  name  (4  characters) 
cccccc  = record  select  start  time  (HHMMSS) 
dddddd  = record  select  stop  time  (HHMMSS) 

eeee  = summary  parameter  (MMSS)  denotes  frequency  of  summary 
data  output 

ffff  = subprogram  activation  frequency  (in  half-seconds) 


4,2,4  Phase  1 End  Card  Format 

This  card  is  used  to  indicate  the  end  of  the  Phase  1 request  cards. 


(See  Figure  4-1), 

Card 
Columns : 


ENDPH1 


4.2.5  Phase  2 Request  Card  Format 

This  card  is  used  to  request  SVC  and  execution  information  for  programs 

running  in  parallel  for  a specified  time  period.  (See  Figure  4-2). 

Field  Card 
Card 

Columns : 127 


PH2TIME  aaaaaa  bbbbbb  dddd,dddd, , , ,dddd 
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Second  Card 
Card 

Columns : 1 

1 4 2 

dddd , dddd , dddd , . . . . dddd 


where 

aaaaaa  - record  select  start  time 
bbbbbb  = record  select  stop  time 

dddd, 
dddd , . . . 

List  of  four  character  names  of  subprograms  requested, 
running  onto  second  card  if  necessary.  Note  that  if 
a continuation  card  is  used  and  completely  filled  with 
4-character  subprogram  names  through  CC  72,  exactly 
22  subprograms  can  be  requested  (including  those  on  a 
fully-used  first  card).  This  is  the  maximum  number  of 
subprograms  which  can  be  reported  on  a Phase  2 output 
listing  (see  Figure  5-2). 


4.2.6  Phase  2 End  Card  Format 

This  card  is  used  to  indicate  the  end  of  the  Phase  2 requests  (See 
Figure  4-2). 

Card 

Columns : 0 

1 

ENDPH2 


4.2.7  Phase  4 Request  Card  Format 

This  card  is  used  to  request  a summary  of  SVC  calls  by  subprogram  for 
a specified  period  of  time  (See  Figure  4-4). 

Card 

Columns : 1 

19  6 

PH4TIME  aaaaaa  bbbbbb 
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//SYSIN  DD  * 

8 N 0300 

PH8TIME  234900  235959 
ENDPH8 


Figure  4-8.  Sample  Input  Deck  - Phase  8 
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Card 

Columns : 1 

19  6 

PH9TIME  aaaaaa  bbbbbb 

where 

aaaaaa  * record  select  start  time 
bbbbbb  = record  select  stop  time 

4.2.12  Phase  9 End  Card  Fermat 

This  card  is  used  to  indicate  the  end  of  the  phase  9 request  (See 
Figure  4-9). 

4.3  Tape  Input 

The  tape  input  to  this  program  is  a Model  3 SAR  tape.  The  input  tape 
is  a tape  that  may  be  reduced,  under  card  control,  to  generate  the 
output  listings. 
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SECTION  5 - OUTPUT 


TARP  outputs  consist  of  printer  output. 


5.1  Tape  and  Environment  Diagnostics 


The  tape  and  environment  diagnostic  messages  indicate  an  error  in  available 
hardware,  in  tape  mounting,  or  in  the  tapes  themselves. 


Refer  to  Section  6,  Diagnostics,  for  actual  message  formats  and  their 
meanings. 


5 . 2  Card  Diagnostics 

The  card  diagnostic  messages  are  printed  with  the  card  in 

error.  Refer  to  Section  6,  Diagnostics,  for  actual  messages  and  their 

meanings. 


5.3  Phase  1 Output 


Figure  5-1  is  a sample  of  Phase  1 output.  The  meanings  of  the  column 
headings  are  as  follows: 

PEID  - Program  Element  Identification 
ACTIVA  TIME  - Time  PGM  was  activated 

DELACT  TIME  - Time  between  this  activate  and  the  next  activate 

FINIS  TIME  - Time  PGM  finished 

ACT  TIME  - Total  time  PGM  was  active 

EX  TIME  - Time  spent  in  execution 

SUS  TIME  - Time  spent  in  suspension 

ET+ST  - Total  execution  and  suspend  time 

DAT  - Difference  between  time  active  and  total  execution  and 
suspend  time 
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Figure  5-1.  Phase  1 Output  Cl  of  2) 
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CE  - Which  CES/PGM  used  for  execution 

TCEX  - TARE  count  for  first  CE  used 

TCLY  - TARE  count  for  second  CE  used 

MAXL'T  - Maximum  execution  time  for  this  summary  period 

AVGET  - Average  execution  time  for  this  period 

MAXAT  - Maximum  activated  time  for  this  period 

AVGAT  - Average  activated  time  for  this  period 

5 . 4 Phase  2 Output 

Figure  5-2  illustrates  a sample  of  Phase  2 output. 

5.5  Phase  4 Output 

Figure  5-3  illustrates  a sample  of  Phase  4 output.  The  field  meanings 
are  as  follows: 

SVC  - SVC  name 
ID  - SVC  number 

aaaaaa/bbbbbb  - total  number  of  times  a specific  SVC  was  issued 
for  a particular  program  over  the  number  of  times  that  SVC 
was  not  honored 

5.6  Phase  8 Output 

Figure  5-4  illustrates  a sample  of  Phase  8 output. 

5.7  Phase  9 Output 

1.  HRT  tape 

2.  TARE  count  summary  report,  if  TARE's  are  encountered.  This 
report  will  also  indicate  the  start  and  stop  time  of  the  HRT 
tape. 

Figure  5-5  illustrates  a sample  of  Phase  9 output. 


Figure  5-2.  Phase  2 Output  (2  of  3) 


THIS  PASS  IS  BUST  QUALITY  FRANTIC ABU 
FROM  007Y  FURMSHSD  TO  DOC 


; 


?►«  IffiND 

FCI  SVC  COCIS 

IS  AS  FCILChU 

COCi 

SVC 

. AC 

ACCEPT 

. .. 

AS 

ASGN 

■A 

ERANCN 

- ...  ... 

Cl 

CEASE 

. CM 

CAACEL  _ 

— «...  . 

CO 

CCAFI6 

• 

CT 

CNTAL 

.... 

Ot 

OE  ►A NO 

m. 

CELETE 

«« 

EXPR 

er 

ETIVE 

- - - 

c * 

l*CP 

H 

FETCH 

FI 

AIMS 

M 

FREPAIH  .... 

_ ... 

*« 

FREE 

....  60  . . 

. COE  

, . _ 

C* 

CE1RAIN 

HC  . 

wio 

IA 

IASGN 

LA 

LACRI 

•It 

LIAR 

..  . t« 

ICCR  , ... 

IS 

LEASE 

•c 

*CVC 

NO 

ACFSC 

M 

FFETCH 

,T  1 

FCINT 

. »C  . 

AECCRD  

AO  ' 

AE»0 

• 

RE  \ 

RESUME 

At  ' 

RELEASE 

AP 

REC»P 

a 

RV 

RESERVE 

A»  , 

• ELAT 

SC  ‘ 

SCFEOl 

SO 

ScAO 

sc 

SELECT 

s« 

SRIP 

s* 

SPCI 

St 

SEIZE 

TO 

TESPSO 

TS  • 

TE  RPSV 

TU 

TEF-SU 

UR 

LMCCR 

Ml 

LA  IT  TO 

. • VR 

VR1TE 

ZC 

z:cre 

se 

SEA/XMM 

RT  • 

• TIME 

R S 

RSETE 

CO 

CO 

TL- 

TS  LOR 

TK 

• TSLLK 

* 


i 


i 

i 


Figure  5-2. 


Phase  2 Output  (3  of  3) 
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Figure  5-4.  Phase  8 Output  (1  of  3) 
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Figure  5-4,  Phase  8 Output 
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Figure  5-5.  Phase  9 Output 
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SECTION  6 - DIAGNOSTICS 

6.1  Tape  and  Environment  Diagnostics 

The  following  messages  indicate  an  error  in  available  hardware,  in  tape 
mounting,  or  in  the  tapes  themselves. 


• BAD  HEADER  ON  SAR  TAPE 

A tape  read  error  occurred  while  reading  SAR  header. 

The  job  is  terminated. 

• ONE  RECORD  SKIPPED  ON  SAR  TAPE 

A tape  read  error  occurred  while  reading  the  SAR  tape. 

One  physical  record  was  skipped  and  processing  continues. 

• PGM  NAME  NOT  ON  COMPOOL 

The  subprogram  requested  is  either  spelled  wrong  or  is 
not  on  the  Compool  being  used  for  this  run.  The  request 
is  not  processed. 

• ONE  LINE  MISSING  HERE 

A tape  read  error  has  occurred  while  reading  the  work  tape 
during  printing  of  the  Phase  2 listing.  Processing  continues. 


6.2  Card  Diagnostics 

The  following  diagnostics  are  printed  with  the  card  in  error. 

• PHASE  CTL  CD  MISSING,  THIS  ONE  GENERATED 

The  Phase  control  card  was  not  found  in  the  input  stream 
and  one  was  generated  using  default  values. 

• NO  PHASE,  7 ASSUMED  or  BAD  PHASE,  7 ASSUMED 

One  of  these  two  messages  is  printed  if  the  phase  number  is 
either  missing  or  is  not  valid  on  the  phase  control  card.  Valid 
phase  numbers  are  1 through  7.  Phase  number  7 is  assumed. 
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• NO  COMP  IND,  N ASSUMED 

BAD  COMP  IND,  N ASSUMED  °r 

One  of  these  two  messages  is  printed  if  the  Compool  indicator 
is  either  missing  or  invalid  on  the  phase  control  card.  Valid 
values  are  N for  no  Compool  on  the  tape  and  Y for  Compool 
present  on  the  file.  It  is  assumed  that  there  is  no  Compool 
on  the  tape- 

• NO  TIME  FREQ,  0300  ASSUMED  Qr 
BAD  TIME  TREQ,  0300  ASSUMED 

Ore  of  these  two  messages  is  printed  if  the  internal  timer 
frequency  is  either  missing  or  not  numeric  on  the  phase  control 
card.  For  either  case,  an  internal  timer  frequency  of  0300 
is  assumed . 

• PGM  NAME 

The  program  name  on  this  Phase  1 request  card  is  either  too 
short  or  too  long.  The  request  is  rejected- 

• START 

The  start  time  on  this  Phase  1 request  card  is  invalid.  It  is 
either  non-numeric  or  greater  than  235959.  The  request  is 
rejected . 

• STOP 

The  stop  time  on  this  Phase  1 request  card  is  invalid.  It  is 
either  non-numeric  or  greater  than  235959.  The  request  is 
rejected . 

• SUMMARY 

The  summary  parameter  on  this  Phase  1 request  card  is  invalid 
(non-numeric).  The  request  is  rejected. 
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PERIOD 

The  subprogram  frequency  parameter  on  this  Phase  1 request  card 
is  invalid  (non-numeric).  The  request  is  rejected. 

BAD  PHASE  CONTROL  WORD 

The  Phase  2 or  4 request  card  does  not  have  TIME  in 
columns  4-7.  The  request  card  is  rejected. 

BAD  START  TIME 

This  Phase  2 or  4 request  card  has  an  invalid  start  time.  It 
is  either  non-numeric  or  greater  than  235959.  The  request 
is  rejected. 

BAD  STOP  TIME 

This  Phase  2 or  4 request  card  has  an  invalid  stop  time.  It  is 
either  non-numeric  or  greater  than  235959.  The  request  is 
rejected. 

LIB  UNIT  NOT  AVAILABLE  - CANNOT  CONTINUE 

The  LIB  unit  is  not  available  and  no  alternate  unit  is  used. 

Job  is  terminated. 

NO  UNIT  AVAILABLE  FOR  SAR  - CANNOT  CONTINUE 

There  are  not  enough  units  available  to  allow  mounting  the 

SAR  tape.  Job  is  terminated. 

BAD  HEADER  ON  SAR  TAPE 

Tape  read  error  occurred  while  reading  SAR  header.  Job  is 
terminated. 

NO  VALID  REQUEST  CARDS  FOUND  PLACE  CARDS  IN  READER  AND  HIT 
ENTER  IF  MORE  INPUT,  OR  TYPE  END  TO  TERMINATE 

No  valid  request  cards  have  been  read.  Either  all  of  the  request 
cards  had  errors,  or  there  were  no  request  cards  in  the  run  deck. 


r 

If  run  is  made  on-line  and  all  request  cards  are  invalid, 
type  END  to  terminate  job,  fix  cards  and  rerun  job.  If  request 
cards  are  not  in  run  deck  and  valid  model  and  place  control 
cards  were  present , place  request  cards  in  reader  and  hit 
ENTER  key  to  continue;  otherwise  type  END,  put  run  deck  together 
and  rerun  job.  If  run  is  made  off-line,  type  END  to  terminate 
job,  put  run  deck  together  correctly,  and  rerun  job. 

• ONE  RECORD  SKIPPED  ON  SAR  TAPE 

A tape  read  error  has  occurred  while  reading  the  SAR  tape. 

The  bad  record  is  skipped,  and  processing  continues  with  the 
next  physical  record. 

; . • EOF  REACHED  ON  THIS  REEL 

HIT  ENTER  IF  MORE  INPUT,  OR  TYPE  END  TO  STOP  RUN 

End  of  file  reached  on  the  SAR  tape.  If  all  requests  have  been 

satisfied,  the  second  line  of  this  message  is  not  typed,  normal 

end  of  job  processing  is  done,  and  the  run  is  finished.  If  all 

requests  have  not  been  satisfied,  the  second  message  is  typed. 

If  there  is  another  SAR  tape  to  be  used,  the  operator  should 


mount  the  next  SAR  tape  and  hit  ENTER  for  processing  to  continue. 
If  the  next  SAR  tape  is  not  available,  or  not  to  be  used  for 
this  run,  type  END  to  finish  job. 

THE  DATE  ON  THIS  REEL  DOESN'T  MATCH  DATE  ON  PREVIOUS  REEL 
When  more  than  one  reel  of  input  is  used  in  a run,  every  tape 
must  have  the  same  date  as  on  the  first  tape.  If  the  dates  are 
not  the  same,  the  tape  is  probably  labeled  wrong  or  is  not 
from  the  CFC  run  which  generated  the  first  tape. 
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SECTION  7 - JOB  CONTROL  LANGUAGE 

TARP  requires  six  DD  statements  for  normal  operation.  Figures  7-1  and 
7-2  shows  sample  JCL  for  the  phases  of  TARP. 

7.1  SYS IN 

The  SYSIN  DD  statement  defines  the  control  card  input  file.  The  file 
must  be  blocked  and  be  80-character  card  images. 

7 . 2 SYSTWR 

The  SYSTWR  DD  statement  defines  the  output  file  for  messages  intended 
for  the  system  console.  Messages  originally  intended  for  the  operator 
are  written  to  this  data  set  so  the  user  may  see  any  error  messages 
that  were  not  output  to  a print  data  set.  This  data  set  may  be 
blocked  and  must  have  a logical  record  length  of  132. 

7.3  SYSPRS 

The  SYSPRS  DD  statement  defines  the  output  print  file.  All  report 
output  and  control  card  listings  are  written  to  this  file.  This  data 
set  may  be  blocked  and  must  have  a logical  record  length  of  133. 

7 . 4 SCRATCH 

The  SCRATCH  DD  statement  defines  a temporary  data  set  used  by  TARP. 

No  DCB  information  should  be  included  on  the  DD  statement. 

7 . 5 SARDD 

The  SARDD  DD  statement  defines  the  SAR  tape  input  file.  Any  number  of 
SAR  tapes  may  be  input  as  long  as  they  are  in  the  order  that  they  were 
produced. 
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The  HRTDD  statement  defines  the  output  tape  file  for  Phase  9 processing. 
This  should  be  a standard  label  tape  with  an  undefined  record  format. 

For  phases  other  than  Phase  9,  a dummy  DD  statement  may  be  supplied. 


ww» 


//TARP  LXLC  PGM~TARP  ,REGI0N=2S0K 
//STEPLIB  DD  DSN  = HA.  LTB . LOBJ . NOSS,DISP=SHR 
(lj  //HRTDD  DD  DUMMY 

(2)  //SCRATCH  DD  DSN=RA.TARP.XXXX,UNIT=SYSDA,DISP=( ,PASS) , 
//  SPACE=  ( TRK,  ( BOO , 5 ) ) ,VOL=SER-WnRK01 

(5)  //SYSIN  DD  * 


mis  PASS  IS  BEST  QUALITY  FfUCTieABU 
jrom  oopy  mraasKB)  ro  ddc 


control  card  input 


(4)  //SARDD  DD  DCB=(DEN=2 ,RECFM=U,LRECI.=  10000, BLKSIZE=10000) , 
//  UNIT=(TAPE,, DEFER), DSN=XCF1B14,V0L=SER=CF1514, 

//  LABEL=( ,NL , , IN ) ,DISP= ( OLD , KEEP ) 

(5)  //SYSPR5  DD  SYS0UT=A,DCB=(BLKSIZE=133,RECFM=FBA,LRECL=133) 
(E)  //SYSTWP  DD  SYSOUT=A ,DCB= (BLKSIZE=133 ,LRECL=133 ,RECFM=FBA) 


Figure  7-1.  Sample  JCL  for  Phases  1-8 


NOTES : 


(1)  The  HRT  DD  statement  is  dummy  because  no  HRT  tape  is  to  be 
created. 


( 2 ) The  SCRATCH  data  set  is  a temporary  data  set  used  mostly 
for  phase  2 processing. 


(3)  Control  cards  follow  the  SYSIN  DD  statement. 

(4)  The  SARDD  DD  statement  defines  the  SAR  tape  input  file. 
(B)  The  SYSPRS  defines  the  print  data  set. 


(6)  The  SYSTWR  defines  the  output  data  set  for  messages 
intended  for  the  system  console. 
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//TAPP  EXEC  PGM=TARP  , REGION=  2 bOK 

//STEPLIB  DD  DSN=RA. LIB . LOBJ .NOSS , DISP=SIIR 

//HRTDD  DD  DCB=(DEN=2,RECFM=U,LRECL=10000,BLKSIZE=10000) , 

//  UNIT= ( TAPE , , DEFER ) , DSN=XXXXXX , 

//  LABEL= ( ,SL,,OUT),DISP=(NEW,PASS) 

//SCRATCH  DD  DSN=RA. SCRATCH, UNIT=SYSDA,DISP=( ,TASS) , 

//  SPACE=(TRK,(100,5) ) 

//SYSIN  DD  * 

control  card  input 

//SAP.DD  DD  DCB=(DEN=2,RECFM=U,LRECL=10000,BLKSIZE=10000), 
//  UNIT= ( TAPE , , DEFER ) , DSN=XCF1601 ,V0L=SER=CF1601 , 

//  LABEL=( ,NL, ,IN ) ,DISP=( OLD, KEEP) 

//SYSPRS  DD  SYSOUT=A ,DCB=(BLKSIZE=133 ,RECFM=FBA,LRECL=133 ) 
//SYSTWR  DD  SYSOUT=A , DCB=(BLKSIZE=133 ,LRECL=133 ,RECFM=FBA) 


Figure  7-2.  Sample  JCL  for  Phase  9 


NOTES : 

(1)  The  HRTDD  DD  statement  defines  a standard  label  output  tape 
to  receive  the  HRT  data. 


The  remaining  DD  statements  are  same  as  in  Figure  7-1. 
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